package com.blkj.iam.system.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.blkj.iam.common.model.Option;
import com.blkj.iam.system.model.entity.Dept;
import com.blkj.iam.system.model.form.DeptForm;
import com.blkj.iam.system.model.query.DeptPageQuery;
import com.blkj.iam.system.model.query.DeptQuery;
import com.blkj.iam.system.model.vo.DeptPageVO;
import com.blkj.iam.system.model.vo.DeptVO;
import com.blkj.iam.system.model.vo.ShowDeptInfoVO;

import java.util.List;

/**
 * 部门业务接口
 *
 * @author haoxr
 * @since 2021/8/22
 */
public interface DeptService extends IService<Dept> {
    /**
     * 部门列表
     *
     * @return 部门列表
     */
    List<DeptVO> getDeptList(DeptQuery queryParams);

    /**
     * 部门树形下拉选项
     *
     * @return 部门树形下拉选项
     */
    List<Option<Long>> listDeptOptions();

    /**
     * 新增部门
     *
     * @param formData 部门表单
     * @return 部门ID
     */
    Long saveDept(DeptForm formData);

    /**
     * 修改部门
     *
     * @param deptId   部门ID
     * @param formData 部门表单
     * @return 部门ID
     */
    Long updateDept(Long deptId, DeptForm formData);

    /**
     * 删除部门
     *
     * @param ids 部门ID，多个以英文逗号,拼接字符串
     * @return 是否成功
     */
    boolean deleteByIds(String ids);

    /**
     * 获取部门详情
     *
     * @param deptId 部门ID
     * @return 部门详情
     */
    DeptForm getDeptForm(Long deptId);

    /***
     * 生成部门树路径
     * @param parentId
     * @return: java.lang.String
     */
    String generateDeptTreePath(Long parentId);

    /***
     * 获取部门数据--客户端用
     * @param departId
     * @return: com.blkj.iam.system.model.vo.ShowDeptInfoVO
     */
    ShowDeptInfoVO getClientDeptInfo(String departId);

    /**
     * 获取用户部门数据
     *
     * @param
     * @param deptType
     * @return: java.util.List<com.blkj.iam.common.model.Option < java.lang.Long>>
     */
    List<Option<Long>> listUserDeptOptions(int deptType);

    /**
     * 部门列表
     *
     * @return 部门列表
     */
    List<DeptVO> getStationDeptList(DeptQuery queryParams);

    /**
     * 部门分页列表
     *
     * @return 部门分页列表
     */
    IPage<DeptPageVO> getStationDeptPage(DeptPageQuery pageQuery);
}
